[App Service] az webapp deploy, az webapp up : Add enriched deployment failure logs for quicker resolution#32940
Open
[App Service] az webapp deploy, az webapp up : Add enriched deployment failure logs for quicker resolution#32940
az webapp deploy, az webapp up : Add enriched deployment failure logs for quicker resolution#32940Conversation
added 3 commits
March 9, 2026 14:21
️✔️AzureCLI-FullTest
|
|
| rule | cmd_name | rule_message | suggest_message |
|---|---|---|---|
| webapp deploy | cmd webapp deploy added parameter enriched_errors |
||
| webapp up | cmd webapp up added parameter enriched_errors |
Collaborator
|
Thank you for your contribution! We will review the pull request and get back to you soon. |
|
The git hooks are available for azure-cli and azure-cli-extensions repos. They could help you run required checks before creating the PR. Please sync the latest code with latest dev branch (for azure-cli) or main branch (for azure-cli-extensions). pip install azdev --upgrade
azdev setup -c <your azure-cli repo path> -r <your azure-cli-extensions repo path>
|
microsoft-github-policy-service
bot
requested review from
wangzelin007,
yonzhan and
zhoxing-ms
Contributor
There was a problem hiding this comment.
Pull request overview
Adds a context-enriched deployment error experience for App Service webapp deployments so failures produce a structured “Copilot context” block (errorCode/stage/metadata/causes/fixes) instead of generic status-only errors.
Changes:
- Introduces a deployment failure pattern catalog and a context builder/formatter for enriched CLI errors.
- Wraps zip deploy + OneDeploy flows in
appservice/custom.pyto raise enriched errors for webapps (skipping function apps). - Adds unit tests covering pattern matching, context building, formatting, and end-to-end error flow simulation.
Reviewed changes
Copilot reviewed 4 out of 4 changed files in this pull request and generated 6 comments.
| File | Description |
|---|---|
src/azure-cli/azure/cli/command_modules/appservice/custom.py |
Hooks enriched error raising into zipdeploy and OneDeploy error paths. |
src/azure-cli/azure/cli/command_modules/appservice/_deployment_failure_patterns.py |
Defines known failure patterns and matching heuristics. |
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py |
Builds YAML “Copilot context” + formatted enriched deployment error message. |
src/azure-cli/azure/cli/command_modules/appservice/tests/latest/test_deployment_context_engine.py |
Unit/integration-style tests for the new pattern/context/error flow. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py
Outdated
Show resolved
Hide resolved
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py
Show resolved
Hide resolved
Shi1810
changed the title
az webapp deploy az webapp up az webapp deployment source config-zip Added enriched deployment failure promptaz webapp deploy, az webapp up, az webapp deployment source config-zip - Added enriched deployment failure prompt
added 2 commits
March 31, 2026 18:15
…shikhajha/errorcontext
vageorge00
reviewed
Apr 1, 2026
src/azure-cli/azure/cli/command_modules/appservice/_deployment_failure_patterns.py
Outdated
Show resolved
Hide resolved
vageorge00
reviewed
Apr 1, 2026
src/azure-cli/azure/cli/command_modules/appservice/_deployment_context_engine.py
Outdated
Show resolved
Hide resolved
Shi1810
changed the title
az webapp deploy, az webapp up, az webapp deployment source config-zip - Added enriched deployment failure promptaz webapp deploy, az webapp up - Added enriched deployment failure prompt
added 2 commits
April 2, 2026 15:23
Shi1810
changed the title
az webapp deploy, az webapp up - Added enriched deployment failure promptaz webapp deploy, az webapp up : Added enriched deployment failure logs for quicker resolution
Shi1810
changed the title
az webapp deploy, az webapp up : Added enriched deployment failure logs for quicker resolutionaz webapp deploy, az webapp up : Add enriched deployment failure logs for quicker resolution
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Related command
az webapp deployaz webapp upaz webapp deployment source config-zipDescription
Currently, only raw error messages are logged in the event of deployment failures.
With this update, customers will have access to the --enriched-error feature flag, allowing them to view detailed failure logs and resolve errors more efficiently.
This feature flag will be available for the
az webapp deployandaz webapp updeployment commands.Testing Guide
az webapp deploy --name wa-bench-b1-10mb-20260316-1513 --resource-group rg-deploy-bench-centralus --src-path test_bad.war --type war --enriched-errors true
az webapp deploy --name wa-bench-b1-10mb-20260316-1513 --resource-group rg-deploy-bench-centralus --src-path test_bad.war --type war
az webapp up --name wa-bench-b1-10mb-20260316-1513 --resource-group rg-deploy-bench-centralus --enriched-errors true
History Notes
[App Service]
az webapp up: Add --enriched-errors parameter to see detailed deployment failure log.[App Service]
az webapp deploy: Add --enriched-errors parameter to see detailed deployment failure log.This checklist is used to make sure that common guidelines for a pull request are followed.
The PR title and description has followed the guideline in Submitting Pull Requests.
I adhere to the Command Guidelines.
I adhere to the Error Handling Guidelines.